home *** CD-ROM | disk | FTP | other *** search
/ Acorn C C++ Development Suite / Acorn C C++ Development Suite.iso / ReadMe
Text File  |  2002-12-12  |  6KB  |  170 lines
  1. ** IMPORTANT **
  2. ===============
  3.  
  4. Please read the following prior to using !Instal_CC, you may
  5. find it helpful.
  6.  
  7. Please contact c-support@iyonix.com if you have any problems
  8. installing this product.
  9. Updates can be found at www.iyonix.com/c-support/
  10.  
  11. Acorn C/C++ Acorn's Application Development Environment.
  12. ********************************************************
  13.  
  14. Overview
  15. ========
  16. This program will install the new 32bit compatible 'AcornC/C++'
  17. Tools on your computer and ensure you have the latest
  18. Shared C Library and supporting modules installed.
  19. It can also optionally install either one or both of the text
  20. editors, !StrongEd or !Zap, for connivance of editing your
  21. source code. Also if you currently have 'AcornC_C++' installed
  22. on your system you may choose to have it updated for use
  23. along side the new 32bit compatible tools for producing 26bit
  24. only software.
  25.  
  26. !System will be modified during the install process, It is
  27. recommended, if you wish for any reason to restore your
  28. original !System, that you make a backup copy prior to running
  29. !Instal_CC. On computers with the 'new' !Boot structure
  30. (Typically RISC OS 3.5 and above) the !System application can
  31. usually be found in !Boot.Resources.
  32.  
  33. If you encounter problems with versions or RISC OS
  34.  
  35. Some versions of RISC OS Select may require a patch before the 32bit
  36. Shared C Library can be loaded. This patch can be applied by
  37. copying the !Boot shell in the 'Extras.Select' directory on this
  38. CD over your existing !Boot.
  39. If you experience Difficulties loading the 32bit
  40. Shared C Library on RISC OS Select please e-mail c-support@castle.uk.co
  41. with details.
  42.  
  43.  
  44.  
  45. Installing !StrongEd and/or !Zap on 26bit computers
  46. ===================================================
  47. Both !StrongEd and !Zap are very advanced text editors, both
  48. are highly capable of making editing of your source code
  49. (and many types of text based files) easier.
  50. If you currently have !StrongEd od !Zap installed on your
  51. computer and you want to install a copy from this CD then you
  52. should read the "Notes on installing !StrongEd or !Zap" section
  53. in this document.
  54. If you have trouble running either of these editors after you
  55. have installed them, then load them from "AcornC/C++.Tools"
  56. while holding down the Ctrl key to load the default configuration.
  57.  
  58.  
  59. Updating AcornC_C++ on 26bit computers 
  60. ======================================
  61. If you own an older version of  AcornC_C++ and have it installed
  62. on your computer then you may wish to use the update option
  63. offered by !Instal_CC to enable you to compile 26bit only code.
  64. This should only be necessary for compiling code that is to run
  65. on systems that are not able to run the latest Shared C Library.
  66. If you wish to be able to compile 26bit only code using
  67. AcornC_C++ then be sure to drop your copy of !SetPaths into
  68. the !Instal_CC program window when prompted.
  69. After Installation, if you wish to use AcornC_C++ for
  70. compiling 26bit only code then ensure "AcornC_C++.!SetPaths"
  71. has been run prior to compilation.
  72.  
  73.  
  74. You may now use !Instal_CC
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81. **------------------------------------------------------**
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88. Technical Notes
  89. ===============
  90. You are not required to read the following sections, they are
  91. for reference only. 
  92.  
  93.  
  94. What this Installer does...
  95. ===========================
  96. The default installation will install AcornC/C++ in the
  97. directory of your choosing. Any 26bit(AcornC_C++) Library
  98. tools that are seen in the Run Path will be collected up and
  99. moved into AcornC/C++.!Setpaths.Lib26.
  100. !System will be merged with the !System included with this
  101. installer.
  102.  
  103. If you choose to update an existing !SetPaths form AcornC_C++
  104. the Lib26 directory will be moved into it, and the !Run and
  105. !Boot files within will be updated to add Lib26 to the
  106. Run$Path. If found, the original version of the FrontEnd
  107. module is copied to "AcornC_C++.!Setpaths" also, so it can be
  108. invoked on machines running versions of RISC OS that are
  109. unwilling to load the new Shared C library.
  110. You may now run "AcornC_C++.!SetPaths" to compile 26bit only
  111. code, or "AcornC/C++.!SetPaths" to compile 26/32bit compatible
  112. code.
  113.  
  114. Notes on Loading the Shared C Library on 26bit computers
  115. ========================================================
  116. Some Versions of RISC OS Select need to be patched to allow the new
  117. Shared C Library (CLib) to be loaded. Please note that currently
  118. RISCOS Ltd. will be unable to provide support for your system
  119. while the new CLib is in use.    
  120.  
  121.  
  122.  
  123. Notes on installing !StrongEd or !Zap on 26bit computers
  124. ========================================================
  125.  
  126. If you are happy with your installation with either of these
  127. editors then there is no need to install them from this CD
  128.  
  129. If you choose to install !StrongED (4.65) or !Zap (1.44 Test 9)
  130. then the main applications respectively and their resources will
  131. be installed into "AcornC/C++.!SetPaths.Resources" And launchers
  132. for each application respectively will be installed into
  133. "AcornC/C++.Tools".
  134.  
  135. Also their extra resources will be installed into
  136. "<Choices$Dir>" and "<BootResources$Dir>" where necessary.
  137.  
  138. Any current resources for these applications that are not
  139. seen as the required versions will be backed up inside the
  140. new resource. Eg. an old version of "<Choices$Dir>.!StrEd_Cfg"
  141. will be moved to "<Choices$Dir>.!StrEd_Cfg.~!StrEd_Cfg"
  142. !ZapUser and !ZapFonts are also handled in this way.
  143.  
  144. The resources in "<Choices$Dir>" and "<BootResources$Dir>" will
  145. be used by default but if either !StrongEd or !Zap is run
  146. from "AcornC/C++.Tools" while the Ctrl key is held down then
  147. the known good configuration in "AcornC/C++.!SetPaths.Resources"
  148. will be used. This can be done to confirm if problems are
  149. due to user configuration.
  150.  
  151. If you have older versions or either Zap or StrongEd on your
  152. system, they may be surprised to find newer Choices and Resources
  153. have been installed. It is unlikely that you will be able to run
  154. old versions along side new versions. 
  155.  
  156.  
  157.  
  158. Notes on 26/32bit compile mode switching for 26bit computers
  159. ============================================================
  160. The system variable C$Mode will report which tools you
  161. currently have configured to use. When switching from one
  162. mode to another you must run the relevant !SetPaths for the
  163. mode you require and ensure all your 'o' files get remade.
  164. And ensure you do not use absolute paths for Libraries in
  165. your MakeFiles
  166.  
  167. Modules made in 32bit mode may still contain some 26bit code
  168. to remain backwardly compatible. This code will only be
  169. execute when the processor is running in a 26bit mode. 
  170.